═══════════════════════════════════════════════════════════════
  JoeCAD Basic 2.01 - Руководство пользователя Linux
═══════════════════════════════════════════════════════════════

Добро пожаловать в JoeCAD Basic!

Это профессиональное CAD-приложение для создания ЦМР и ЦММ.

──────────────────────────────────────────────────────────────
  УСТАНОВКА
──────────────────────────────────────────────────────────────

JoeCAD поставляется в формате AppImage и НЕ ТРЕБУЕТ установки!

Шаг 1: Скачайте файл
   JoeCAD-Basic-2.01.0.0-x86_64.AppImage

Шаг 2: Сделайте файл исполняемым
   Откройте терминал в папке со скачанным файлом и выполните:
   
   chmod +x JoeCAD-Basic-2.01.0.0-x86_64.AppImage

   Или через файловый менеджер:
   Правая кнопка мыши → Свойства → Права → ✓ Исполняемый

Шаг 3: Запустите программу
   В терминале:
   
   ./JoeCAD-Basic-2.01.0.0-x86_64.AppImage
   
   Или просто дважды кликните по файлу в файловом менеджере

──────────────────────────────────────────────────────────────
  СИСТЕМНЫЕ ТРЕБОВАНИЯ
──────────────────────────────────────────────────────────────

Минимальные:
• ОС: Любой Linux дистрибутив (2018+ года)
• Архитектура: x86_64 (64-bit)
• Память: 2 GB RAM
• Место на диске: 500 MB

Рекомендуемые:
• ОС: Ubuntu 20.04+ / Debian 11+ / Fedora 35+
• Процессор: 2+ ядра
• Память: 4 GB RAM
• Графика: OpenGL 2.1+

Протестировано на:
✓ Ubuntu 20.04, 22.04, 24.04
✓ Debian 11, 12
✓ Fedora 38, 39
✓ Linux Mint 21
✓ Pop!_OS 22.04
✓ Manjaro

──────────────────────────────────────────────────────────────
  ПЕРВЫЙ ЗАПУСК
──────────────────────────────────────────────────────────────

При первом запуске JoeCAD:

1. Может появиться запрос FUSE (для старых систем):
   sudo apt-get install fuse libfuse2

2. Создастся папка с настройками:
   ~/.config/JoeCAD/        (настройки программы)
   ~/.local/share/JoeCAD/   (данные пользователя)

3. Если требуется лицензия, скопируйте файл license.json в:
   ~/.joecad/license.json

──────────────────────────────────────────────────────────────
  ОСНОВНЫЕ ВОЗМОЖНОСТИ
──────────────────────────────────────────────────────────────

• Импорт точек из TXT, DXF, GeoJSON
• Построение триангуляционной сети (TIN)
• Автоматическое создание горизонталей
• Ручное редактирование контуров
• Структурные линии
• Топографические условные знаки
• Экспорт в DXF (версии 2000, 2004, 2007, 2010)
• Система слоёв и цветов
• Профессиональное оформление

──────────────────────────────────────────────────────────────
  ИНТЕГРАЦИЯ С РАБОЧИМ СТОЛОМ
──────────────────────────────────────────────────────────────

Для удобства можно создать ярлык:

1. Создайте файл ~/.local/share/applications/joecad.desktop

2. Вставьте следующее содержимое:

[Desktop Entry]
Type=Application
Name=JoeCAD Basic
Comment=Professional CAD for surveying
Exec=/полный/путь/к/JoeCAD-Basic-2.01.0.0-x86_64.AppImage
Icon=/полный/путь/к/иконке/joecad.png
Categories=Graphics;Engineering;
Terminal=false

3. Обновите базу приложений:
   update-desktop-database ~/.local/share/applications

Теперь JoeCAD появится в меню приложений!

──────────────────────────────────────────────────────────────
  ЛИЦЕНЗИРОВАНИЕ И АКТИВАЦИЯ
──────────────────────────────────────────────────────────────

JoeCAD Basic использует систему лицензирования на основе
цифровой подписи.

ПЕРВЫЙ ЗАПУСК (без лицензии):

1. Программа запускается в Demo-режиме
2. Через 3 секунды появится окно "Активация JoeCAD"
3. В окне отображается КОД ЗАПРОСА (HWID) - уникальный код вашего компьютера
4. Нажмите кнопку "Копировать HWID" и отправьте код продавцу
5. Получите от продавца КОД АКТИВАЦИИ
6. Вставьте код активации в поле ввода
7. Нажмите "Активировать"
8. Готово! Программа переключится в полный режим

ВАЖНО:
• HWID привязан к оборудованию вашего компьютера
• Одна лицензия работает только на одном компьютере
• После активации лицензия сохраняется автоматически
• При следующих запусках активация не требуется

Файлы лицензии (создаются автоматически):
• ~/.joecad/license.json - информация о лицензии
• ~/.joecad/license.b64 - зашифрованная подпись

Альтернативный способ (если получили готовые файлы):
1. Создайте папку: mkdir -p ~/.joecad
2. Скопируйте файлы license.json и license.b64 в ~/.joecad/
3. Запустите программу - активация произойдёт автоматически

──────────────────────────────────────────────────────────────
  УСТРАНЕНИЕ НЕПОЛАДОК
──────────────────────────────────────────────────────────────

Проблема: "Permission denied"
Решение:
   chmod +x JoeCAD-Basic-2.01.0.0-x86_64.AppImage

Проблема: "FUSE not found"
Решение:
   Ubuntu/Debian: sudo apt-get install fuse libfuse2
   Fedora:        sudo dnf install fuse fuse-libs
   Arch:          sudo pacman -S fuse2

Проблема: "Qt platform plugin could not be initialized"
Решение:
   sudo apt-get install libqt5gui5 libqt5svg5 libqt5widgets5

Проблема: Нет звука или графики
Решение:
   Запустите с переменной окружения:
   QT_QPA_PLATFORM=xcb ./JoeCAD-Basic-2.01.0.0-x86_64.AppImage

Проблема: Программа не запускается
Решение:
   1. Проверьте права: ls -l *.AppImage
   2. Запустите в терминале для просмотра ошибок
   3. Проверьте логи: ~/.config/JoeCAD/logs/

Проблема: Окно активации не появляется
Решение:
   1. Удалите старые файлы лицензии: rm -rf ~/.joecad/
   2. Перезапустите программу
   3. Окно активации должно появиться через 3 секунды

Проблема: "Неверный формат BASE64/JSON"
Решение:
   1. Убедитесь, что вы скопировали код активации полностью
   2. Удалите лишние пробелы и переносы строк
   3. Код должен начинаться с символов типа "eyJ..." или "{"

Проблема: "HWID не совпадает"
Решение:
   1. Вы получили лицензию для другого компьютера
   2. Скопируйте ВАШ HWID из сообщения об ошибке
   3. Отправьте новый HWID продавцу для генерации правильной лицензии

Проблема: "Подпись не подтверждена"
Решение:
   1. Код активации повреждён или неправильный
   2. Запросите новый код активации у продавца
   3. Убедитесь, что копируете код без изменений

Проблема: Лицензия не распознаётся после активации
Решение:
   1. Проверьте файлы: ls -la ~/.joecad/
   2. Убедитесь, что license.json валидный JSON
   3. Проверьте права: chmod 644 ~/.joecad/license.*
   4. Попробуйте активировать заново

──────────────────────────────────────────────────────────────
  УДАЛЕНИЕ
──────────────────────────────────────────────────────────────

Для полного удаления JoeCAD:

1. Удалите файл AppImage:
   rm JoeCAD-Basic-2.01.0.0-x86_64.AppImage

2. Удалите настройки (опционально):
   rm -rf ~/.config/JoeCAD
   rm -rf ~/.local/share/JoeCAD
   rm -rf ~/.joecad

3. Удалите ярлык (если создавали):
   rm ~/.local/share/applications/joecad.desktop

──────────────────────────────────────────────────────────────
  ОБНОВЛЕНИЕ
──────────────────────────────────────────────────────────────

Для обновления до новой версии:

1. Скачайте новый AppImage
2. Сделайте его исполняемым
3. Запустите новую версию
4. Старые настройки сохранятся автоматически
5. Удалите старый AppImage (опционально)

──────────────────────────────────────────────────────────────
  ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ
──────────────────────────────────────────────────────────────

❓ Нужен ли root для установки?
   → Нет! AppImage работает без прав администратора

❓ Можно ли запустить с USB-флешки?
   → Да! Скопируйте AppImage на флешку и запустите

❓ Работает ли на Wayland?
   → Да, но может потребоваться QT_QPA_PLATFORM=wayland

❓ Можно ли использовать на нескольких компьютерах?
   → Нужна отдельная лицензия для каждого компьютера

❓ Как получить лицензию?
   → 1) Запустите программу
   → 2) Скопируйте HWID из окна активации
   → 3) Отправьте HWID продавцу
   → 4) Получите код активации и введите в программу

❓ Сохранится ли лицензия после переустановки системы?
   → Нет, HWID изменится. Понадобится новая лицензия

❓ Что делать, если поменял железо?
   → HWID изменится, нужно получить новую лицензию у продавца

❓ Лицензия работает одинаково в Windows и Linux?
   → Да! Процесс активации идентичный

❓ Как обновить программу?
   → Просто скачайте новый AppImage, лицензия сохранится

❓ Где хранятся проекты?
   → В любой папке по вашему выбору (файлы .json)

❓ Совместим ли с Wine/Windows программами?
   → Нет, это нативное Linux приложение

──────────────────────────────────────────────────────────────
  ПОДДЕРЖКА
──────────────────────────────────────────────────────────────

Техническая поддержка:
📧 Email: support@joecad.top
🌐 Сайт: https://joecad.top

По вопросам активации и лицензирования:
• Отправьте ваш HWID на email поддержки
• Укажите в теме письма: "Активация JoeCAD Linux"
• Приложите подтверждение покупки (если требуется)
• Вы получите код активации в течение 24 часов

──────────────────────────────────────────────────────────────
  ЛИЦЕНЗИЯ И АВТОРСКИЕ ПРАВА
──────────────────────────────────────────────────────────────

© 2025 JoeCAD. Все права защищены.

Это коммерческое программное обеспечение.
Использование регулируется лицензионным соглашением.

Несанкционированное копирование, распространение или
модификация программы запрещены.

──────────────────────────────────────────────────────────────
  БЛАГОДАРНОСТИ
──────────────────────────────────────────────────────────────

JoeCAD использует следующие open-source библиотеки:
• PyQt5 - GUI фреймворк
• NumPy, SciPy - научные вычисления
• Matplotlib - визуализация
• ezdxf - работа с DXF
• ReportLab - генерация отчётов

Спасибо сообществу разработчиков!

═══════════════════════════════════════════════════════════════

JoeCAD Basic 2.01.0.0
Professional CAD for Linux
Build Date: 2025-10-15

Спасибо за использование JoeCAD! 🚀

═══════════════════════════════════════════════════════════════

